前端canvas项目实战——简历制作网站(五)：右侧属性栏(字体、字号、行间距)

目录

• 前言
• 一、效果展示
• 二、实现步骤
• • 1. 优化代码，提取常量
  • 2. 实现3个编辑模块
  • 3. 实现updateFontProperty方法
  • 4. 一个常见的用法：仅更新当前选中文字的样式
  • 三、Show u the code
  • 后记

    前言

    上一篇博文中，我们扩充了线条对象（fabric.Line）的属性列表，使用户可以为画布中选中的线条增加或修改端点样式（多种剪头、圆形、菱形等）。

    这篇博文是《前端canvas项目实战——简历制作网站》付费专栏系列博文的第五篇——右侧属性栏(字体、字号、行间距)，主要的内容有：

    1. 针对文本框（fabric.Textbox）对象： 扩充属性列表，使用户可以修改画布中选中的文本框的字体、字号和行间距。
    2. 在实现了整体更新文本框属性的基础上，还实现了仅更新用户选中的部分文字的样式。

    如有需要，可以：

    • 点击这里，返回第一篇《前端canvas项目实战——简历制作网站(一)——左侧工具栏》
    • 点击这里，返回上一篇《前端canvas项目实战——简历制作网站(四)——右侧属性栏(线条端点样式)》

    ---

    一、效果展示

    • 动手体验

      CodeSandbox会自动对代码进行编译，并提供地址以供体验代码效果

      由于CSDN的链接跳转有问题，会导致页面无法工作，请复制以下链接在浏览器打开：

      https://cy37vt.csb.app/

    • 动态效果演示

      • 本节之后，我们的简历能做成什么样子

        我们可以修改字体、字号和行间距了

        ---

        二、实现步骤

        作为简历，其中包含最多的就是文字。因此，文字的各种样式至关重要，我们在本节初步实现字体、字号和行间距的编辑能力。

        1. 优化代码，提取常量

        当我们实现越来越多的编辑模块时，object-props.js文件越来越大。其中包含了很多我们为下拉菜单的菜单项设置的常量，这些常量不需要经常修改，但占据了很多行。为了避免这个文件过于庞大，以及做好Modal和View的分离，我们将这些数据拆分到一个constants.js常量文件中。

        const fontFamilyOptions = [
          { key: "黑体", value: "SimHei", platform: "windows" },
          { key: "黑体", value: "STHeitiSC-Light", platform: "mac" },
          ...
          "Times New Roman",
          "Georgia",
          ...
        ];
        const fontSizeOptions = [
          { key: "初号", value: 36 },
          { key: "小初", value: 31 },
          ...
          9,
          10,
          ...
        ];
        const lineHeightOptions = [ 
          0, 
          2,
          4, 
          ...
        ];
        export { fontFamilyOptions, fontSizeOptions, lineHeightOptions };
        

        我们将本节新增定义的fontFamilyOptions, fontSizeOptions和lineHeightOptions提取到了这个文件中，它们分别是字体、字号和行间距的可取值列表。

        2. 实现3个编辑模块

        这里的3个编辑模块的代码逻辑大同小异，且互相独立，各不影响。所以仅列出fontFamily字体属性编辑模块的实现。

         import { fontFamilyOptions } from "../../apis/constants";
          
          const isWindows = navigator.userAgent.toUpperCase().indexOf("WIN") !== -1;
          const isMac = navigator.userAgent.toUpperCase().indexOf("MAC") !== -1;
          const FontFamilyWrapper = (props) => { const optionFilter = (option) => { return (
                !option.hasOwnProperty("key") ||
                (option.platform === "windows" && isWindows) ||
                (option.platform === "mac" && isMac)
              );
            };
            const menuItems = useMemo(() => { return fontFamilyOptions.filter(optionFilter).map((option, index) => { let _key = option, _value = option;
                if (option.hasOwnProperty("key")) { _key = option.key;
                  _value = option.value;
                }
                return ( `font-family-${_key}`} value={_value} style={{ fontFamily: _value }}> {_key}  );
              });
            });
            return ( 
        props.key}> 字体 
         fontFamily} bordered={false} style={{ width: "100%" }}
                    onChange={(value) => canvasAPI.updateFontProperty("fontFamily", value)}> {menuItems}  
         
         );
          };
        

        由上述代码可见，共分为4个部分，下面分别讲解：

        1. 从常量文件constants.js中引入定义好的字体常量
        2. 由于同样的字体在Windows和Mac系统中的名称不同，而我们的项目目前没有后台的支持，所以暂且区分不同系统来实现字体。这里在后续章节中开始实现后台服务器时将会重构。
        3. 组装下拉菜单的菜单项，这里与之前的章节类似。
        4. 绘制字体的下拉菜单，这里用户选择了不同的字体后，onChange事件调用canvasAPI.updateFontProperty方法去更新整个文本框的字体，让每个字符都使用相同的字体。

        3. 实现updateFontProperty方法

         static updateFontProperty(key, newValue) { let { activeObject, canvas } = store.getState();
            ObjectAPI.updateProperty(activeObject, key, newValue);
            canvas.renderAll();
          }
        

        这里的代码很简单，直接调用了updateProperty方法，去更新整个Textbox的fontFamily、fontSize和lineHeight等属性。

        updateProperty方法的实现在上一篇博文中有列出，这里不再赘述。如需回顾，可点击前往

        4. 一个常见的用法：仅更新当前选中文字的样式

        在目前的实现中，我们可以直接设置整个Textbox的属性，这样其中的所有字符都会设置为相同的属性。但有时，我们会选中其中的部分文字，然后单独更新它们的属性。 这个时候就需要更加细致的实现来区分两种情况。

        首先确定目标，我们要实现的效果如下图所示：

        我们实现以下代码在一个CanvasAPI.js文件中：

         // 1. 判断是否对整个Textbox更新属性
          static shouldUpdateTheWholeTextbox(object, key) { return !object?.isEditing || key === "lineHeight";
          }
          // 2. 更新Textbox的属性
          static updateFontProperty(key, newValue) { let { activeObject, canvas } = store.getState();
            if (this.shouldUpdateTheWholeTextbox(activeObject, key)) { CanvasAPI._updateFontPropertyForWholeObject(key, newValue);
            } else { CanvasAPI._updateFontPropertyForSelection(key, newValue);
            }
            canvas.renderAll();
          }
          // 3. 更新整个Textbox的属性
          static _updateFontPropertyForWholeObject(key, newValue) { let { activeObject } = store.getState();
            ObjectAPI.updateProperty(activeObject, key, newValue);
          }
          // 4. 更新Textbox中当前选中的部分文字的属性
          static _updateFontPropertyForSelection(key, newValue) { let { activeObject, canvas } = store.getState();
            let style = {};
            style[key] = newValue;
            activeObject.setSelectionStyles(style);
          }
        

        代码逻辑比较清晰，共分为4个方法，下面分别解析：

        1. shouldUpdateTheWholeTextbox方法: 判断当前状态下，应该整体更新文本框的属性，还是仅更新选中的文字的属性。逻辑上，处于非编辑态的文本框适用前者，否则适用后者。这里有一个特殊属性lineHeight行间距。根据定义，这个属性只能对整个文本框设置，不能仅对选中的文字设置。

        2. updateFontProperty方法: 前文中实现过的方法，这里根据shouldUpdateTheWholeTextbox的返回值区分两种状态，调用不同的方法更新文本框属性。

        3. _updateFontPropertyForWholeObject方法: 更新整个文本框的属性。

        4. _updateFontPropertyForSelection方法: 仅更新文本框中当前选中的文字的属性。

        ---

        三、Show u the code

        按照惯例，本节的完整代码我也托管在了CodeSandbox中，点击前往，查看完整代码

        ---

        后记

        这篇博文中，我们实现了对文字的字体、字号和行间距的编辑。同时，根据我们日常的使用习惯，实现了对部分用户选中的文字的属性进行单独地编辑。

        作为简历中占据最大部分空间的文字对象，本章的实现很大程度上实现了用户在制作简历时的核心需要。当然，这还远远不够。在下一篇博文中，我们将实现设置文字的加粗、斜体、删除线、下划线等能力。

        如有需要，可以：

        • 点击这里，返回第一篇《前端canvas项目实战——简历制作网站(一)——左侧工具栏》
        • 点击这里，返回上一篇《前端canvas项目实战——简历制作网站(四)——右侧属性栏(线条端点样式)》