kigh-ota / exceljs Goto Github PK

exceljs#1147

https://github.com/kigh-ota/exceljs/compare/master...kigh-ota:exceljs:support-shapes?expand=1

Doc Model

{
  props: {
    type: 'line' | 'rect' | etc.
    fill?: Fill
    outline?: Outline
  }
  range
}

Fill: { type: 'solid', color: {theme: string, argb: string}}
Outline: {}

• NonVisual Properties
  • 位置・サイズ　range
  • hyperlink?
• Shape Properties
  • 形状　geometry: preset|custom
  • 塗りつぶし　fill: no|solid|grad|blip|patt|(grp?)
  • 枠線　outline
    • fill: no|patt|grad
    • dash: preset|custom
    • bevel(?)
    • miter(?)
    • headEnd
    • tailEnd
  • effect(?)
  • 3d(?)
• Style
  • line reference
  • fill reference
  • effect reference
  • font reference
• Text Body
  ...

優先度？

• 形状・サイズ・位置のみを指定して図形を追加できる
  • addShape(properties, range)
  • Properties { geometry: 'rect'|'rountRect' }
• 図形のsolid fillの色を指定できる
  • schemeClr
  • srgbClr
  • scrgbClr（TextboxのlnRefにデフォルトで付いてるっぽい）
  • そのほか
• 枠線
  • 色
  • 太さ
  • ダッシュ
  • 先端
• LineReference, FillReference を対応する
• 図形に文字列（改行なくてよい）を置ける
• 図形にハイパーリンク
• 文字列に改行、段落
• 文字のスタイル
  • フォント
  • サイズ
  • 色
  • 太字/斜体/下線
  • 打ち消し線
• 回転・反転
• 文字の配置
• 形状を全対応 https://learn.microsoft.com/ja-jp/dotnet/api/documentformat.openxml.drawing.shapetypevalues?view=openxml-2.8.1
• documentation
• 優先度低い
  • custom geometry
  • gradient fill

Xform Model

• xdr:sp
  • xdr:nvSpPr
    • xdr:cNvPr
      • a:hlinkClick
      • a:extLst
    • xdr:cNvSpPr
  • xdr:spPr
    • a:xfrm
      • a:off x, y
      • a:ext cx, cy
    • custGeom
    • a:prstGeom
      • a:avLst
    • a:noFill
    • a:solidFill
      • a:schemeClr
        • a:shade
      • a:scrgbClr r,g,b
        • ...many children
      • RgbColorModelHex
      • HslColor
      • SystemColor
      • PresetColor
    • gradFill
    • blipFill
    • pattFill
    • grpFill
    • a:ln
      • a:noFill
      • a:solidFill
        • ...
      • GradientFill
      • PatternFill
      • PresetDash
      • CustomDash
      • Round
      • LineJoinBevel
      • Miter
      • HeadEnd
      • TailEnd
      • ExtensionList
    • effectLst
    • effectDag
    • scene3d
    • sp3d
    • extLst
  • xdr:style
    • a:lnRef
      • a:schemeClr
      • a:scrgbClr
        • ...
      • RgbColorModelHex
      • HslColor
      • SystemColor
      • PresetColor
    • a:fillRef
      • ...
    • a:effectRef
      • ...
    • a:fontRef idx
      • schemeClr
      • a:scrgbClr r,g,b
      • RgbColorModelHex
      • HslColor
      • SystemColor
      • PresetColor
  • xdr:txBody
    • a:bodyPr (many attrs)
      • ...many children
    • a:lstStyle
      • ...many children
    • a:p
      • a:pPr algn
        • ...many children
      • a:r
        • a:rPr
        • a:t
      • a:br
      • a:endParaRPr
      • a:fld

方針

Read

• XLSX
  • 変更不要そう。DrawingXform をちゃんと呼んでる
• DrawingXform
  • 変更不要そう。TwoCellAnchorXform, OneCellAnchorXform を呼んでいる
• TwoCellAnchorXform https://learn.microsoft.com/ja-jp/dotnet/api/documentformat.openxml.drawing.spreadsheet.twocellanchor?view=openxml-2.8.1
  • Parse Shape(sp)
  • 一旦やらない：contentPart, cxnSp, graphicFrame, grpSp
• OneCellAnchorXform
  • Parse Shape(sp)
• SpXform
  • Parse itself
  • Parse NonVisualShapeProperties(nvSpPr)
  • Parse ShapeProperties(spPr)
  • Parse ShapeStyle(style)
  • Parse TextBody(txBody)
• NvSpPrXform
  • Parse itself
  • Parse NonVisualDrawingProperties(cNvPr) *existing
  • Parse NonVisualShapeDrawingProperties(cNvSpPr)
• SpPrXform
  • すでにある
• StyleXform
• TxBodyXform

SpXformの構造

• SpXform
  • xdr:nvSpPr Add
    • xdr:cNvPr (CVnPrXform)
    • xdr:cNvSpPr Add
  • xdr:spPr (SpPrXform) Add
    • a:xfrm (Transform2D)
      • a:ext
      • a:off
    • ...
  • xdr:style Add
    • ...
  • xdr:txBody Add
    • ...

Write

TBW

参考

PicXformの構造

• PicXform
  • xdr:nvPicPr (NvPicPrXform)
    • xdr:cNvPr (CVnPrXform)
      • a:hlinkClick (HlickClickXform)
      • a:extLst (ExtLstXform)
    • xdr:cNvPicPr (CNvPicPrXform)
  • xdr:blipFill (BlipFillXform)
    • a:blip (BlipXform)
  • xdr:spPr (StaticXform)