CSS Classes
We recommend using these classes to style your designs. Not only are these
classes implemented in the @freesewing/plugin-theme
plugin, they are also
properly styled in our own frontends. Furthermore, by using a common set
of class names, anyone can adapt the styling to suit their own needs.
It is this styling that you will see below. What the various classes exactly look like will depend on the environment where you use FreeSewing, because in-browser styling or SVG/PDF styling is slightly different. But what doesn't change is the names of the classes and their purpose.
Contextual colors
These are the main classes that you typically want to use.
The will set either the stroke
or fill
property, depending on the element you set them on.
For example, when you use these classes on a path, they will set the stroke
property.
But if you use them on text, they will set the fill
property.
Which is typically what you want.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const colors = [
'fabric',
'lining',
'interfacing',
'canvas',
'various',
'mark',
'contrast',
'note',
]
const w = 120
let y = 0
for (const color of colors) {
y += 12
paths[color] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass(color)
.addText(`path.${color}`, `left text-sm`)
paths[`${color}Text`] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass('hidden')
.addText(`text.${color}`, `${color} right text-sm`)
}
paths.noClip = new Path()
.move(new Point(0, -1))
.move(new Point(10, -1))
return part
}
Stroke colors
These classes set the stroke
property explicitly.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const colors = [
'fabric',
'lining',
'interfacing',
'canvas',
'various',
'mark',
'contrast',
'note',
]
const w = 120
let y = 0
for (const color of colors) {
y += 12
paths[color] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass(color)
.addText(`path.stroke-${color}`, `left text-sm`)
paths[`${color}Text`] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass('hidden')
.addText(`text.stroke-${color}`, `stroke-${color} right text-sm`)
}
paths.noClip = new Path()
.move(new Point(0, -1))
.move(new Point(10, -1))
return part
}
Fill colors
These classes set the stroke-fill
property. Note that we've applied a background
to ensure the text remains readable.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const colors = [
'fabric',
'lining',
'interfacing',
'canvas',
'various',
'mark',
'contrast',
'note',
]
const w = 120
let row = 1
let i = 0
let y = 15
for (const color of colors) {
const h = 10
points[`${color}PathBg`] = new Point(2, y*row+8).addText(`path.fill-${color}`, 'stroke-interfacing left text-sm')
points[`${color}Path`] = new Point(2, y*row+8).addText(`path.fill-${color}`, 'left text-sm')
points[`${color}TextBg`] = new Point(w-2, y*row+8).addText(`text.fill-${color}`, `stroke-${color === 'fabric' ? 'interfacing' : 'fabric'} fill-${color} right text-sm`)
points[`${color}Text`] = new Point(w-2, y*row+8).addText(`text.fill-${color}`, `fill-${color} right text-sm`)
paths[color] = new Path()
.move(new Point(0, y*row))
.line(new Point(w, y*row))
.line(new Point(w, y*row+h))
.line(new Point(0, y*row+h))
.close()
.setClass(`fill-${color} no-stroke`)
row++
i++
}
paths.noClip = new Path()
.move(new Point(0, 20))
.move(new Point(10, 21))
return part
}
Stroke styles
These classes set the stroke-dasharray
property.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const styles = [
'dotted',
'dashed',
'lashed',
'sa',
'help',
'hidden',
]
const w = 120
let y = 0
paths.dflt = new Path()
.move(new Point(0, 0))
.line(new Point(w, 0))
.addText(`[default]`, 'center')
for (const style of styles) {
y += 12
paths[style] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass(style)
.addText(`.${style}`, 'center')
}
paths.noClip = new Path()
.move(new Point(0, -8))
.move(new Point(10, -8))
return part
}
Stroke widths
These classes set the stroke-width
property.
The default width is shown at the top.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const widths = [
'stroke-xs',
'stroke-sm',
'stroke-lg',
'stroke-xl',
'stroke-2xl',
'stroke-3xl',
'stroke-4xl',
]
const w = 120
let y = 0
let i = 0
paths.dflt = new Path()
.move(new Point(0, 0))
.line(new Point(w, 0))
.addText(`[default]`, 'center')
for (const width of widths) {
i++
y += 12 + i
paths[width] = new Path()
.move(new Point(0, y))
.line(new Point(w, y))
.setClass(width)
.addText(`.${width}`, 'center')
.attr('data-text-dy', -0.6*i)
}
paths.noClip = new Path()
.move(new Point(-20, -8))
.move(new Point(140, 110))
return part
}
Font size
These classes set the stroke-width
property.
The default width is shown at the top.
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const sizes = [
'text-xs',
'text-sm',
'text-lg',
'text-xl',
'text-2xl',
'text-3xl',
'text-4xl',
]
let y = 0
let i = -2
points.dflt = new Point(0,0).addText(`[default]`)
for (const size of sizes) {
i++
y += 12 + i*5.5
points[size] = new Point(0, y).addText(`.${size}`, size)
}
paths.noClip = new Path()
.move(new Point(-5, -8))
.move(new Point(190, 175))
return part
}
Text alignment
These classes set the text-anchor
property.
The default align is to the left (text-anchor: start;
).
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const w = 120
paths.left = new Path()
.move(new Point(0, 0))
.line(new Point(w, 0))
.addText('Default is left-aligned')
paths.center = new Path()
.move(new Point(0, 12))
.line(new Point(w, 12))
.addText('.center', 'center')
paths.right = new Path()
.move(new Point(0, 24))
.line(new Point(w, 24))
.addText('.right', 'right')
paths.noClip = new Path()
.move(new Point(-5, -8))
.move(new Point(10, 15))
return part
}
Bold and italic text
- Preview
- Code
- X-Ray
({
Point,
Path,
points,
paths,
store,
options,
part
}) => {
const w = 120
paths.left = new Path()
.move(new Point(0, 0))
.line(new Point(w, 0))
.addText('Default text', 'center')
paths.center = new Path()
.move(new Point(0, 12))
.line(new Point(w, 12))
.addText('.bold', 'bold center')
paths.right = new Path()
.move(new Point(0, 24))
.line(new Point(w, 24))
.addText('.italic', 'center italic')
paths.noClip = new Path()
.move(new Point(-5, -8))
.move(new Point(10, 15))
return part
}
Various:
.no-stroke
: Do not stroke the element.no-fill
: Do not fill the element