整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

HTML 简单的<li> 标签

HTML 两个列表实例: 一个有序列表 (<ol>) 和 一个无序列表 (<ul>) :

<ol>

<li>Coffee</li>

<li>Tea</li>

<li>Milk</li>

</ol>

<ul>

<li>Coffee</li>

<li>Tea</li>

<li>Milk</li>

</ul>


浏览器支持

目前多数主流浏览器支持 <li>标签。


标签定义及使用说明

<li> 标签定义列表项目。

<li> 标签可用在有序列表(<ol>)、无序列表(<ul>)和菜单列表(<menu>)中。


HTML 4.01 与 HTML5之间的差异

"type" 属性 在 HTML 4.01 已被废弃。HTML5 不支持该属性。

"value" 属性 在 HTML 4.01 已被废弃。HTML5 不支持该属性。


提示和注释

提示: 请使用 CSS 来定义列表和列表项目的类型。


属性

属性描述
type1AaIidiscsquarecircleHTML5 不支持该属性。HTML 4.01 已废弃该属性。 不赞成使用。请使用样式取代它。 规定使用哪种项目符号。
valuenumber不赞成使用。请使用样式取代它。 规定列表项目的数字。

全局属性

<li> 标签支持全局属性,查看完整属性表 HTML 全局属性。


事件属性

<li> 标签支持所有 HTML 事件属性。

如您还有不明白的可以在下面与我留言或是与我探讨QQ群308855039,我们一起飞!


lt;h2 id="title1">开发工具(工欲善其事必先利其器)</h2>

  • 为了让大家更快的融入到编程的世界中, 不被繁琐的英语单词所困扰, 不用每天编写很多没有意义的重复代码, 提升大家的开发效率今后的课程中我们统一采用最高级高发工具来编写网页

<h3 id="title2">常见的前端开发工具</h3>

  • 记事本: 提示功能较差

  • editplus/nodepad++: 提示功能较差

  • Dreamwaver: 更偏向设计

  • Sublime: 轻量级,自带功能不太全, 但是插件十分丰富

  • WebStorm: 重量级, 自带功能全面

  • 其它ide(zend studio、netbean等)

  • 为了让大家更快的融入到编程的世界中, 不被繁琐的英语单词所困扰, 今后的课程中我们统一采用最牛逼最高级的高发工具WebStorm

<h3 id="title3">WebStorm安装和使用</h3>

  • 安装软件

1.png

2.png

3.png

4.jpg

5.jpg

6.png

7.jpg

8.png

  • 破解软件

9.png

10.png

11.jpg

12.jpg

13.png

14.png

  • 汉化软件

15.png

16.jpg

  • 设置模版

  • 创建文件

17.png

18.jpg

关注微信订阅号:网页设计轻松学 有更多内容

19.png

  • WebStorm常见快捷键

  • 如何在WebStorm中利用快捷键创建一个新的.html的文件

    • 同时按下键盘上的Ctrl + Alt + Insert

  • 如何在WebStorm中让光标移动到当前行的末尾

    • 按下键盘上的End键即可

  • 如何在WebStorm中让光标移动到当前行的最前面

    • 按下键盘上的Home键即可

  • 如何在WebStorm中让光标在多行中闪烁

    • 按住键盘上的Alt键不放, 然后再按住鼠标的左键不放, 然后再拖动鼠标即可

  • 如何在WebStorm中快速的复制光标所在的那一行

    • 按下键盘上的Ctrl + D

  • 如何在WebStorm中快速的删除光标所在的那一行

    • 按下键盘上的Ctrl + X

  • 如何在WebStorm中让标签包裹一段内容, 也就是自动在一段内容前后加上标签

    • 按下键盘上的Ctrl + Alt + T, 然后按下回车, 然后输入对应的标签即可


<h2 id="title4">基础标签学习</h2>

<h3 id="title5">H系列标签(Header 1~Header 6)</h3>

  • 作用:

    • 用于给文本添加标题语义

  • 格式:

    • <h1>xxxxxx</h1>

  • 注意点:

    • H标签是用来给文本添加标题语义的, 而不是用来修改文本的样式的

    • H标签一共有6个, 从H1~H6, 最多就只能到6, 超过6则无效

    • 被H系列标签包裹的内容会独占一行

    • 在H系列的标签中, H1最大, H6最小

    • 在企业开发中, 一定要慎用H系列的标签, 特别是H1标签. 在企业开发中一般情况下一个界面中只能出现一个H1标签(和SEO有关)

<h3 id="title6">P标签(Paragraph)</h3>

  • 作用:

    • 告诉浏览器哪些文字是一个段落

  • 格式:

    • <p>xxxxxxxx</p>

  • 注意点:

    • 在浏览器中会单独占一行

<h3 id="title7">Hr标签(Horizontal Rule)</h3>

  • 作用:

    • 在浏览器上显示一条分割线

  • 格式:

    • <hr />

  • 注意点:

    • 在浏览器中会单独占一行

    • 通过我的观察发现HR标签可以写/也可以不写/, 如果不写/那么就是按照HTML的规范来编写, 如果写上/那么就是按照XHTML的规范来编写.但是在HTML5中, 由于HTML5兼容HTML和XHTML所有写不写都可以.那么以后我们在做前端开发时到底写还是不写呢? 按照高级开发工具的提示来写即可.

    • 由于hr标签是用来修改样式的, 所以不推荐使用. 今后开发中添加水平线一般都使用CSS盒子来做


<h2 id="title8">HTML注释(Annotation)</h2>

  • 什么是注释?

    • 注释是在所有计算机语言中都非常重要的一个概念,从字面上看,就是注解、解释的意思

    • 注释可以用来解释某一段程序或者某一行代码是什么意思,方便直接或程序员之间的交流

  • 为什么要使用注释?

    • 适当的注释,能够让我们的程序更加可读,所以用中文提示自己,这里的程序是干什么的

  • 注释格式

<!--被注释的内容-->
  • 注意点:

    • 被注释的内容不会在浏览器中显示, 注释是写给我们自己看的

    • 注释不能嵌套使用

<!--<!--被注释的内容-->-->
  • 快捷键: ctrl + /


<h3 id="title9">img标签(image)</h3>

  • 作用: 在网页上插入一张图片

  • 格式: ![](图片路径)

  • 标签的属性

    • 写在标签中K="V"这种格式的文本我们称之为标签属性

属性名称作用
src(source)告诉浏览器需要插入的图片路径, 以便于浏览器到该路径下找到需要插入的图片
alt(alternate)规定图像的替代文本, 只有在src指定的路径下找不到图片,才会显示alt指定的文本
title悬停文本(介绍这张图片, 只有在鼠标移动到图片上时才会显示)
height设置图片显示的高度
width设置图片显示的宽度
  • 注意点:

    • img标签添加的图片默认不是占一整行空间

    • 如果想让图片等比拉伸, 只写高度或者宽度即可

关注微信订阅号:网页设计轻松学 有更多内容

<h3 id="title10">br标签(Break)</h3>

  • 作用:

    • 让内容换行

  • 格式:

    • <br/>

  • 注意点:

    • br的意思是不另起一个段落进行换行, 而网页中99.99%需要换行时都是因为另起了一个段落, 所以应该用p来做

<h3 id="title11">相对路径和绝对路径</h3>

  • 图片路径分为两种, 一种是绝对路径, 一种是相对路径, 我们重点学习相对路径, 因为在企业级开发中没有人使用绝对路径

  • 绝对路径

    • 从电脑的具体盘符开始寻找我们需要的资源

    • ![](F:/lnj/girl.png)

    • 以上代码表示在F盘下查找lnj文件夹, 然后在lnj文件夹下查找girl.png图片

  • 相对路径

    • 一个文件相对于另外一个文件的位置寻找我们需要的资源

    • ![](girl.png)

    • 假设html文件和girl.png都在lnj文件夹下, 以上代码表示在lnj文件夹下查找girl.png图片

  • 为什么没人使用绝对路径?

    • 可以移植性太差.

  • 什么是可移植性?

    • 可以简单的理解为把写到的代码拷贝到另外一台电脑上是否能够正常运行

  • 为什么绝对路径可移植性差?

    • 假如我编写的html文件放在我电脑的 F:/lnj 目录下, html文件中用到的图片放在F:/lnj/images目录下, 我给src指定的绝对路为F:/lnj/images/girl.png. 那么将来我将整个lnj文件夹拷贝给你, 如果你将lnj文件夹放在非F盘下, 那么将无法显示图片

    • 例如你存放在C盘根目录, 那么图片的绝对路径会变为C:/lnj/images/girl.png, 而src会去F盘找, 所以不会显示

    • 你只有将lnj文件夹存放在F盘根目录下时图片才会正常运行, 这就叫做可移植性不好

    • Q群;162542073

  • 为什么相对路径可移植性好?

    • 同上, 如果src指定的路径为images/girl.png, 那么无论你拷贝到那个盘, 哪个文件夹. 系统都只会在当前文件夹中的images下去查找图片, 不会受到盘符和存储位置的影响, 只要保证页面和图片位置的相对关系不变就不会影响到图片的显示

  • 相对路径几种查找方式

    • ../代表访问上级目录

    • 假设a文件夹下面有b文件夹, 图片存放在a文件夹中, html文件存放在b文件夹中, 那么路径为../girl.png

    • 因为html文件在b文件夹中, 所以路径是相对于b文件夹的, 所以../代表访问b文件夹的上一级目录, b文件夹的上一级目录是a文件夹, 所以../girl.png就代表在a文件夹查找girl.png

    • 直接编写, 例如abc/girl.png

    • 加上./ 编写, 例如./abc/girl.png

    • 相对当前目录有几个文件夹,就在后面依次补全几个文件夹名称即可, 例如 abc/bbb/ccc/ddd/girl.png./abc/bbb/ccc/ddd/girl.png

    • 直接编写, 例如: girl.png

    • 加上./ 编写, 例如./girl.png

    • ./代表当前目录, ./girl.png代表在当前目录下查找

    • 同级

    • 下级

    • 上级

  • 注意事项:

    • 相对路径不会出现这种格式aaa/../bbb/girl.png

    • 虽然可以显示, 但是企业开发中千万不要这么写

<h3 id="title12">a标签(anchor)</h3>

  • 格式: <a href="http://www.it666.com">江哥博客</a>

  • 作用: 用于从一个页面链接到另一个页面

  • 注意事项:

    • 在a标签之间一定要写上文字, 如果没有, 那么在页面上找不到这个标签

    • a标签也叫做超级链接超链接

  • a标签的属性

属性名称作用
href(hypertext reference)指定跳转的目标地址
target告诉浏览器是否保留原始界面, _blank保留, _self不保留
title悬停文本(介绍这个链接, 只有在鼠标移动到超链接上时才会显示)
  • base标签和a标签结合使用

    • 如果每个a标签都想在新页面中打开,那么逐个设置a标签的target属性比较麻烦, 这时我们可以使用base和a标签结合的方式,一次性设置有a标签都在新页面中打开

    • 格式: <base target="_blank" />

  • 注意事项:

    • base必须嵌套在head标签里面

    • 如果标签上指定了target,base中也指定了target,那么会按照标签上指定的来执行

  • a标签其它用法

    • 例如<a href="girl.zip">下载福利资源<a/>

    • 格式: <a href="01-锚点链接.html#location">跳转到指定位置</a>

    • 只需要在01-锚点链接.html页面添加一个id位置即可

    • 2.1.格式<a href="#location">跳转到指定位置</a>

    • 2.2.在页面的指定位置给任意标签添加一个id属性

    • 例如 <p id="location">这个是目标</p>

    • 格式<a href="#">江哥博客</a>

    • 格式<a href="javascript:">江哥博客</a>

    • 假链接(本质是跳转到当前页面)

    • 跳转到当前页面指定位置(锚点链接)

    • 跳转到指定页面的指定位置

    • 下载(极力不推荐使用)

wagger 提供的注解集是其框架中定义 API 规范和文档的重要工具。这些注解在代码里标注重要部分,为 Swagger 的解析工作铺路,进而生成详尽的 API 文档。开发者编写的注释能够被转换成直观的文档,并展现API端点、参数和响应等信息。这不仅提升了开发人员对 API 运作的理解与沟通,也使得测试和集成过程更加顺畅。

  • 什么是 Swagger?- 全面介绍Swagger 的作用和优点

Swagger 注解的实际应用场景

Swagger 注解在多个方面都非常有益,尤其适用于以下情况:

  1. 开发阶段:定义和记录 API 操作的细微差别,确保团队成员对请求和响应的规格有清晰的认知。
  2. 文档用途:Swagger 注解能够自动生成并展现详细的API文档,对于需要理解、测试或操作 API 的人来说至关重要。
  3. API 测试:注解可与自动化测试工具结合,使测试人员能够直接从注解产生测试用例,简化 API 集成测试流程。

Swagger 注解的实施指南

Swagger 注解的实施通常包括以下步骤:

  1. @Api:这个总括性的注解用来封装 API 级别的信息,如名字、描述和标签。
  2. @ApiOperation:详细说明各个 API 操作,包括操作摘要、描述和所使用的HTTP方法。
  3. @ApiParam:详尽阐述请求参数的细节,包括参数的名称、描述、数据类型和默认值。
  4. @ApiResponse:描述 API 操作可能的结果或响应,指定 HTTP 状态码和消息详情。
  5. @ApiModel:与数据结构或模型有关,提供模型定义、描述和属性的深刻洞见。
  6. @ApiModelProperty:集中描述单一模型属性,列出名称、类型和描述等特性。
  7. @ApiIgnore:从生成的文档中排除特定 API 或操作的注解。

通过在代码中使用这些描写性标识,开发人员为 Swagger 提供了生成文档的基础,这些文档不仅供内部参考,还为那些能自动生成 API 文档的工具和服务铺垫。

在 SpringBoot 项目中配置 Swagger 注解

将 Swagger 注解集成到 SpringBoot 项目中需要一些简单设置,具体步骤如下:

  • SpringBoot 集成并使用 Swagger
  1. 在项目的 pom.xml 文件中添加 Swagger 依赖项:

<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency>

  1. 通过在 Spring Boot 的主类上添加 @EnableSwagger2 注解来激活 Swagger 功能。
  2. 在 Controller 类或方法上添加 Swagger 注解,明确接口细节。
  3. 启动项目,导航至 http://localhost:<端口>/swagger-ui.html 访问自动生成的 API 文档。

下面是一个使用 Swagger 注解的控制器示例:

@RestController
@RequestMapping("/api")
@Api(tags = "用户管理")
public class UserController {
    
    @GetMapping("/user/{id}")
    @ApiOperation(value = "通过 ID 查找用户信息", notes = "使用唯一标识符检索用户详情")
    @ApiImplicitParam(name = "id", value = "用户 ID", required = true, dataType = "Long")
    public User getUserById(@PathVariable Long id) {
        // 此处实现代码...
    }
    
    @PostMapping("/user")
    @ApiOperation(value = "创建新用户", notes = "在系统中添加一个新用户实体")
    public User createUser(@RequestBody User user) {
        // 此处实现代码...
    }
}

在这段代码中,@Api 注解用于接口分组和命名,而 @ApiOperation 和 @ApiImplicitParam 提供了对特定操作和参数的深入理解,从而帮助 Swagger 自动生成文档。

使用 Swagger 注解时的注意事项

使用 Swagger 注解时,用户需注意以下几点:

  1. 注解必须准确且能真实反映 API 的路径、参数和响应,以避免生成文档中出现差错。
  2. 如果 API 的参数或响应较为复杂,可以使用 @ApiModel 和 @ApiModelProperty 注解进行详细描述。
  3. 应当注意请求字段的验证和数据类型的约束,防止出现安全漏洞或错误。
  4. 注意 Swagger 注解的版本兼容问题,不同版本可能会在功能或语法上出现变化。

更好的解决方案建议

虽然 Swagger 在 API 管理中扮演了重要角色,但有时在便捷性、安全性以及团队协作特性方面可能不够完善。因此,更推荐使用 Apifox 及其 IDEA 插件。该整合使你能在 IDEA 环境中自动同步 Swagger 注解至 Apifox,提供一键式文档生成和无缝多平台更新——极大地便利了测试和维护。

Apifox 是一个功能强大的 API 测试工具,它集合了 Postman、Swagger、Mock 和 JMeter 的功能,并支持包括 HTTP(S)、WebSocket、Socket、gRPC、Dubbo 等多种协议。与 IDEA 插件 结合后,开发人员可以动态解析代码注释并根据 Javadoc、KDoc 和 ScalaDoc 标准构建 API 文档,一切都可以在 IntelliJ IDEA 中完成,这要归功于 Apifox Helper 插件。

IDEA 用户可以通过简单的右键操作 "Upload to Apifox" 轻松同步接口信息的变动,无需手动更新。团队成员可在 Apifox 中查看更新后的内容,实现信息的同步更新。

知识扩展:

  • Swagger Array 使用详解
  • Swagger basepath 用法及常见问题详解

参考链接

  • Swagger 官方文档:https://swagger.io/docs/
  • Springfox 官方文档:https://springfox.github.io/springfox/docs/current/