跳到主要内容

自定义 CSS

如果我们的微调 UI 无法完全符合你的品牌，使用自定义 CSS 来定制你的登录体验。只需将你的 CSS 代码添加到我们的编辑器中，即可立即查看更改。

Logto 控制台中的自定义 CSS​

  1. 前往 Console > Sign-in experience > Branding > Custom CSS。
  2. 在左侧编辑器中编辑 CSS 代码，它会立即在右侧预览模式中实时渲染。注意：代码编辑器目前仅支持 CSS 代码。不支持 HTML 或 Javascript。
  3. 保存更改。
  4. 别忘了点击“实时预览”按钮，以检查所有页面上的更改。

要查看 Logto 的组件化界面设计，你可以导航到 GitHub 上的 Logto/packages/experience/src 或在 Logto 实时预览页面上打开浏览器的“检查元素”工具。

示例​

例如，如果你想让你的登录页面在网页视图中呈现 夜之城 的感觉，可以尝试以下 CSS：

@font-face {
  font-family: 'Rock Salt';
  font-style: normal;
  font-weight: normal;
  font-display: swap;
  src: url('https://fonts.gstatic.com/s/rocksalt/v18/MwQ0bhv11fWD6QsAVOZrt0M6p7NGrQ.woff2')
    format('woff2');
  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F,
    U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
@font-face {
  font-family: 'Share Tech';
  font-style: normal;
  font-weight: normal;
  font-display: swap;
  src: url('https://fonts.gstatic.com/s/sharetech/v17/7cHtv4Uyi5K0OeZ7bohU8H0JmBUhfrE.woff2')
    format('woff2');
  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F,
    U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}

#app * {
  font-family: 'Share Tech';
  letter-spacing: 0.5px;
  --color-type-primary: #ffffff;
  --color-type-secondary: #c9c5d0;
}

#app > div[class$='viewBox'] {
  background-image: url('https://silverhand.io/assets/v-in-nc.jpg');
  background-size: cover;
}

#app main[class*='main'] {
  background-image: url('https://logtoeu.blob.core.windows.net/public-blobs/g3cp4y/m-g3cp4y/2024/01/02/w9j0x57g/gentle-universe.png');
  background-size: cover;
  opacity: 97%;
  min-height: initial;
  padding: 24px;
  padding-bottom: 72px;
  border-radius: 12px;
}

#app main[class*='main'] img[class*='logo'] {
  content: url('https://silverhand.io/assets/cyberpunk-2077.png');
  margin: -20px 0 -12px;
  height: 160px;
}

#app form div[class*='inputField'] > div {
  outline: none;
  border: none;
  border-radius: 4px;
}

#app form div[class*='inputField'] input,
#app form div[class*='inputField'] div[class$='countryCodeSelector'] {
  background: initial;
  background-color: #564f7c;
  font-family: 'Share Tech';
  letter-spacing: 0.5px;
  font-size: 16px;
  font-weight: 600;
}

#app form div[class*='inputField'] > div > input::placeholder,
#app main[class*='main'] > div[class*='wrapper'] > div[class*='divider'],
#app main[class*='main'] > div[class*='wrapper'] > form div[class*='content'],
#app main[class*='main'] > div[class*='wrapper'] > form div[class*='content'] > span {
  color: #a7a5b3;
}

#app main[class*='main'] > div[class*='wrapper'] > div[class*='divider'] > i[class*='line'],
#app
  main[class*='main']
  > div[class*='wrapper']
  > div[class*='terms']
  > i[class*='divider']::after {
  background: rgba(247, 248, 248, 14%);
}

#app button {
  font-weight: 600;
  font-size: 16px;
  border-radius: 4px;
}

#app button[type='submit'] {
  background: linear-gradient(270.84deg, #2fd6fb -24.55%, #6369fc 44.33%, #a741eb 119.2%), #5d34f2;
}

#app div[class*='socialLinkList'] *,
#app div[class*='main'] * {
  font-family: 'Share Tech';
}

#app main[class*='main'] > div[class*='wrapper'] > div[class*='createAccount'] {
  font-family: 'Share Tech';
  color: #ffffff;
}

#app div[class*='socialLinkList'] > button {
  border: none;
  background-color: #645995;
}

Logto 自定义 CSS 用例

备注

由于 Logto 使用 CSS 模块，你可能会在 DOM 元素的 class 属性中看到一个哈希值（例如，一个带有 vUugRG_container 的 <div>）。要覆盖这些，你可以使用 $= CSS 选择器来匹配以指定值结尾的元素。在这种情况下，它应该是 div[class$=container]。

通过 Management API 自定义 CSS​

你也可以使用 Management API PATCH /api/sign-in-exp，在请求体中包含 { "customCss": "arbitrary string" } 来为登录体验设置自定义 CSS。你应该会看到 customCss 的值附加在页面的 <title> 之后。如果样式具有更高的优先级，它应该能够覆盖。